home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CD ROM Paradise Collection 4
/
CD ROM Paradise Collection 4 1995 Nov.iso
/
edit
/
pcps800.zip
/
PCPS.MAN
< prev
next >
Wrap
Text File
|
1994-12-07
|
30KB
|
695 lines
PCPS(V8.00) PCPS(V8.00)
------------------------------------------------------------------------------
NAME
MSDOS/OS/2: PCPS.EXE |
MSDOS : PCPSD.EXE |=> convert text to PostScript
UNIX : pcps |
SYNOPSIS
PCPS [-arg1 -arg2 -arg3 ... -argn] [filename(s)]
DESCRIPTION
PCPS reads in text files (now including support of the full IBM/PC
character set), converts them to PostScript and outputs them to a
PostScript printer, a file or stdout. If no input files are
specified, PCPS will take its input from stdin. Many attributes
such as fonts, headings, orientation, various formatting options
etc. may be specified.
****************
* NOTE FOR * PCPS defaults to using European A4 paper size, so
*NORTH AMERICAN* you must specify "-szlt" if you are using US letter
* USERS * paper (8.5" x 11")
****************
The various arguments are detailed below. Any field enclosed in <>
is mandatory for that argument but those enclosed in [] are
optional:
-he or (no arguments AND no stdin pipe)
This will give you a multiple page help screen.
-ls List available font codes. ALL other arguments are ignored
when -ls is used.
-2c[r] Print in 2 columns. This can allow two normal pages to fit
on one.
NOTE: This argument no longer affects the orientation of
the paper, thus allowing 2 column in portrait mode as well
as landscape. The optional "r" specifies the orientation
to be landscape and is identical to specifying "-2c -ro".
* -2c- Print in a single column.
-ap<o|e>
Print alternate pages where o = ODD and e = even. This is
useful when double sided printing is required. For further
double sided support, see "-sm" below.
EXAMPLE: -apo print only odd pages.
* -ap- Turn OFF alternate page printing - print both odd and even.
-bx Draw a BoX around the printable area on the page.
* -bx- Disable Boxing.
-cd The first and last characters output by PCPS will be ^D
(0x04) characters. This is required by some printers to
signify end of job.
* -cd- Do not output ^D (0x04) characters.
-cp<n> Print <n> copies of every page.
* -cp- Print one copy of every page.
-cz Suppress the printing of Ctl-Z characters. This is useful
for printing those text files created by editors that
insist on terminating the file with the DOS EOF character.
* -cz- Print the Ctl-Z character as a right arrow (if font is
IBMPCFont).
-df<s|o|p>
Default action to take when a file already in PostScript
format is encountered, where s = Skip file altogether, o =
Output file as it is and p = process the PostScript into
PostScript.
* -df- Reset default action - if a file is encountered that is
already in PostScript format, the user will be prompted for
the action to take.
-dk Denmark fix for the IBM/PC character set - this maps the
characters oslash and Oslash to decimal 155 and 157
respectively.
* -dk- If the IBM/PC character set is the active font, it will be
unmodified.
-dl Delete the input file(s) after successful processing.
**************** USE WITH CAUTION *******************
PCPS will consider the file processed successfully if it
receives no errors during the processing and will delete
the input file. Be aware that print jobs can sometimes get
lost, especially on networks.
* -dl- Do NOT delete the input file.
-dp[t] Enable DUPLEX mode printing for those printers that support
it. The optional "t" may be specified if tumble is desired.
* -dp- Non-DUPLEX mode - printing will be single sided if the
printer defaults to this.
-dt[1|2|3]
Date format to use in the banner where the formats are:
1 - yyyy/mm/dd
2 - mm/dd/yy (U.S.)
3 - dd/mm/yy (Australia & Europe)
* -dt- Use the default date format (yyyy/mm/dd).
-eh Download the extended PostScript error handler to the
printer before the print job. This error handler causes
the printer to output any errors on paper as well as back
along its comms line.
Use this option carefully as, on many printers, this causes
a permanent change to its error handling routine.
This option should only be used as a last resort if, for
any reason, your printer refuses to print the output from
PCPS and you are unable to monitor your printers errors;
E.g. Most spoolers have a log file and any errors output by
the printer are normally placed into this file, but access
to this file may be impractical.
* -eh- Disable debug mode.
-fn<text>
Replace the file name in the banner with "text".
****See TEXT ARGUMENT RULES.
* -fn- Just use the file name as is in the banner.
-fo<[font code][size]>
This argument is used to set the font type and/or the font
size. The "font code" is the abbreviated code for the font
which is listed by the "-ls" option. The size is in points
and may have a decimal point with one only decimal number.
See SUPPORTED FONTS.
EXAMPLE: -foc12 set font to Courier at size 12 point.
-foc7.5 set font to Courier at size 7.5 point.
* -fo- Set the font and size to the default IBMPCFont at 10 point.
-ga[text]
Print a gaudy banner at the top of the page containing the
files last modification date, the current page number, the
file name. If the optional "text" is included, it will
printed above the filename in the banner.
****See TEXT ARGUMENT RULES.
This argument over-rides any previous -nb argument.
* -ga- Disable the gaudy banner.
-g1[text]
Gaudy banner for page 1 - the same as "-ga" but only prints
the banner on page 1.
****See TEXT ARGUMENT RULES.
* -g1- Disable the gaudy banner.
-id[n] Attempt to identify the originator of the print job by
printing the User ID and Host name at the bottom corner of
each page. The default font size for this string is 4 but
may be changed to "n" where "n" must be greater than or
equal to 3 and may have up to one decimal place.
On DOS or OS/2 systems, this may not work as each different
LAN environment has as different standard of storing such
information, but PCPS looks for some key environment
variable combinations such as:
USER & HOSTNAME (typical of OS/2 TCP/IP)
USERNAME & USERDOMAIN (typical of Windows/NT)
USERID & NFSPATH/NFSDRIVE (PCNFS).
Under Unix, the LOGNAME variable is used, and `hostname` is
executed.
* -id- Disable user identification.
-in[f|o]
Inverse page order (ie. Output the last page first).
"-in" uses the default mode and is the fastest. The pages
will be sorted in memory if there is sufficient memory
to do so. If there is insufficient memory then the "-inf"
mode is automatically selected.
"-inf" is the default temporary file method and is the new
"fast" mode which, although slower than memory sorting, is
far more efficient than the old temporary file sorting
method, especially with large files.
"-ino" may be specified if either of the above arguments are
giving you trouble - this mode requires no additional
memory but is verrrrrry slooooooow.
* -in- Normal page order.
-lf<n> Set the line feed spacing to n% of the font size. The
default is 105%.
* -lf- Set line feed spacing back to the default 105%.
-ll[n] Set Line length: If "n" is not specified, this sets an
(almost) unlimited line length (65535 chars). If "n" is
specified, set line length to "n" characters. Normally
PCPS calculates the maximum line length using the font
size and the available printing area but this calculation
is made assuming the non-proportional default IBMPCFont font
and is not necessarily accurate for other fonts other than
Courier. This argument allows the user to over-ride the
calculated maximum.
EXAMPLE: -ll set maximum char per line to 65,535
-ll60 set maximum char per line to 60
* -ll- Use the default calculated maximum line length.
-ln[n] Print line numbers. The default is for the line numbers to
be shown with 4 digits but should an optional number also
be specified, the line numbers will start with "n" digits
where "n" can be a maximum of 6. The number of digits is
automatically increased should the line numbers exceed the
number able to be specified by the current number of
digits.
EXAMPLE: -ln print line numbers and start with 4 digits.
-ln3 print line numbers and start with 3 digits.
* -ln- Do NOT print line numbers.
-lp<n> Set lines per page to "n" lines.
EXAMPLE: -lp66 set the pages to 66 lines.
-lp- Set lines per page to the default which is to print
whatever will fit on the page or until Form Feed characters
are encountered.
-ma<l|r|t|b><n>
Set the specified margin to be "n" points (1/72 inch)
where l = Left, r = Right, t = Top and b = Bottom.
EXAMPLE: -mal72 set the left margin to 1 inch.
The default margins are as follows:
| Left Right Top Bottom
------------------------------------------------------
Portrait | 36p(.50") 22p(.31") 36p(.50") 36p(.50")
Landscape | 22p(.31") 22p(.31") 36p(.50") 22p(.31")
* -ma- Set the margins back to their defaults.
-mf Enable manual paper feed - useful if you wish to use
different paper than that loaded into the paper tray(s).
-mf1 Enable manual paper feed on the first page printed only -
useful if the first page needs to be printed on letter head
and you are not fortunate enough to have two paper trays.
* -mf- Disable all manual paper feeding.
-mo<1|2>
Enable one of two special processing modes:
Mode 1 => -mo1 (Man Page Mode)
Enable man page printing mode where a backspace physically
executes a backspace rather than printing a white dot.
This mode automatically selects the Courier (which is
non-proportional) in man mode and over-rides any previously
specified font. Any subsequent attempt to change the font
to anything other than Courier will result in an error.
Mode 2 => -mo2 (Mail Message Mode)
Enable Mail mode which will print mail headers in bold
font. This mode automatically selects Courier font, but
the user may follow this argument with a "-fo" argument to
change the font to another.
Be aware that the IBMPCFont does not have an equivalent
bold font and no difference in font will will visible
between the headers and the text. Most of the other
supported fonts however, will use a different "bold" font
for the headers, be it actually bold or maybe some
combination of bold and/or italic.
Any line that contains a colon with some white-space but
only after the colon will be treated as a header, apart
from the first line of the file which will be printed bold
unconditionally.
This mode cancels Man Mode if previously selected.
* -mo- Disable all special processing modes.
-nb Disable banner printing.
* -nb- Enable banner printing.
-nf No Flush - Do not flush out pages between files when in
duplex mode, but follow the next file onto the backside of
the paper if it has not yet been used.
* -nf- Flush pages between files ie. even if the last page of a
file lands on the front side of the sheet of paper with the
backside not yet printed, the page will still be flushed
before starting the next file.
-of<path>
Output PostScript to <path> instead of the default LPT2
where <path> may be a filename (Eg. c:\doc\example.ps) or
the name of another device (Eg. LPT1 or COM1).
EXAMPLE: -ofC:\TEMP\EXAMPLE.PS output the PostScript to
the specified file.
PLEASE NOTE
If PCPS detects that its output is being piped to another
program it will automatically send the PostScript to stdout
and totally ignore any output file specified with this
argument. In this mode, PCPS sends the screen information
to stderr. This feature maybe over-ridden with -of-
* -of- Use the default output file ie. for DOS and OS/2 it is
LPT2 and is piped to lpr for Unix.
PLEASE NOTE
This argument over-rides the autosensing of piped output
and may be followed by a -of<file> or -P<printer> argument
to force the output to a particular destination
** -P<printer name>
Specify a printer name other than the default for output.
The defaults are, for non SYSV: "PostScript", for SYSV:
"lp".
** -P- Set printer name back to the default.
-pp<file path>
Get printer preparation data from the file specified by
<file path>. The contents of this file are sent to the
printer prior to any other output from PCPS. See SUPPORT
FILES.
EXAMPLE: -ppC:\PRINT.PRP Use the file PRINT.PRP under the
directory C:\
NOTE: As a default, PCPS will look for printer preparation
data from the file PCPS.PPF as specified in SUPPORT
FILES.
-pp- Do not use any printer preparation file.
-pr<n[-|,|$>
Specify page ranges to print where a range may be a single
page (n), a range of pages (n1-n2) or from a page to the
end of the document (n-$). Each separate range
specification should be separated by a comma.
EXAMPLE: -pr1-12,35,50-$ print pages 1 through 12, 35 and 50
through to the end of the document.
* -pr- Print all pages.
-pt Add timing code to the PostScript to cause the printer to
dump timing information back out its comms line so that it
may be captured (to a log file for instance). This
information can be useful when analysing printer performance.
* -pt- Disable PostScript timing code.
-qu Quiet mode - no fancy information is displayed. For each
file processed, only the number of pages printed is
displayed.
-qut Quiet Total mode - no screen output at all.
* -qu- Noisy :-) mode with lots of information displayed. This
argument will cancel both -qu and -qut.
-ro Rotate the print 90 degrees to Landscape orientation.
* -ro- Use portrait orientation.
-sh[s<x>][l<y>]
Shade lines with a grey background - useful to make
listings or tables more readable. By default, every second
line will be shaded (ie. y=1) and the shading will be done
at 96% white (ie. x=96).
EXAMPLE: -shl3 Shade 3 lines, leave 3 lines etc.
-shl3s90 As above but with 90% white shading.
* -sh- Do not background shade any lines.
-sm<o|e>
Enable margin swapping for double sided printing on (O)dd
or (E)ven pages.
In Portrait mode the Left and Right margins will be swapped
on the specified pages as well as the Page-number and File-
-time boxes in the Gaudy header if gaudy mode is enabled.
In Landscape mode the Top and Bottom margins are swapped on
the specified pages. No change is performed on the Gaudy
banner.
* -sm- Disable margin swapping.
-sz<xx> Use paper size "xx" which can be any of the following
codes.
VALID CODES: a4 = A4 paper size
lt = US letter paper size
ex = Executive paper size
lg = Legal paper size
mo = Monarch envelope size
co = COM10 envelope size
d1 = D1 envelope size
EXAMPLE: -szlt set the paper size to US letter (11" x 8.5")
* -sz- Use default paper size (A4).
* -tb[n] Expand tab characters to spaces. If "n" is specified, tabs
will be expanded to "n" spaces, otherwise they will be
expanded to 8 spaces.
EXAMPLE: -tb expand all tab characters to 8 spaces (default).
-tb4 expand all tab characters to 4 spaces.
-tb- Do NOT expand tab characters; pass them through untouched.
-tr Truncate lines longer than the maximum number of
characters allowed in the current mode.
* -tr- Disable truncation of lines - wrap them instead.
-ty<x>[,n,y]
Specify the paper tray to start with where "x" may be a
number between 0 and 2, or one of the codes below. This
may be followed by an optional number which specifies
the number of pages "n" to print from this tray before
switching to the tray "y". If both "x" and "y" are
specified, they must both be numbers or both be codes -
you cannot mix codes and numbers.
VALID CODES: a4 = A4 paper tray
lt = US letter paper tray
ex = Executive paper tray
lg = Legal paper tray
mo = Monarch envelope tray
co = COM10 envelope tray
d1 = D1 envelope tray
VALID NUMBERS: 0 = Top tray on most printers
1 = Middle tray on 3 tray or bottom on 2 tray
2 = Bottom on most 3 tray printers
EXAMPLE: -ty0,1,2 print the first page from tray 0 (the top
tray), then switch to tray 2 (the bottom
tray on a printer with 3 trays).
* -ty- Do NOT specify any trays - use the printers default.
-wm<text>
Print "text" as a WaterMark in grey on the background
of each page where "text" may be up to 40 characters.
****See TEXT ARGUMENT RULES.
* -wm- Disable WaterMark printing.
* All arguments preceded by * reflect the default conditions for PCPS.
** Arguments only apply to the UNIX version of PCPS.
Normal DOS style wildcards (* and ?) are allowed when specifying
the input files under DOS and OS/2.
Under UNIX, wildcard expansion is done by the shell you are
utilising at that time.
TEXT ARGUMENT RULES
Any text that is attached to any argument accepting text input
(-fn, -ga, -g1 and -wm) must obey the following rules:
-if it is one word with no white-space, it may just follow the
argument:
E.g. -gaOne_Word_Comment
-if it includes white-space, the whole argument should be enclosed
in double quotes:
E.g. "-wmMulti word comment"
-if the characters sequence "##id" is included anywhere in the
text, it will be replaced with the "user@host" string as is used
in the -id argument, where "user" will be the userid of the person
running the job, and "host" will be the hostid of the machine upon
which the job is running, as determined by PCPS (see -id argument):
E.g. "-fnFrom the desk of ##id"
ENVIRONMENT
PCPSCFG
Points to a directory containing a PCPS configuration file
(See SUPPORT FILES).
PCPSPPF
Points to a directory containing a PCPS printer prep file
(See SUPPORT FILES).
SUPPORT FILES
PCPS can have three support files: pcps.adm, pcps.cfg and pcps.ppf
pcps.adm
This is the Administrator config file which must exist in
the same directory as PCPS, and will be processed before
any other support file or the command line. This file can
contain arguments just the same as command line arguments,
and is therefore useful for System Administrators to specify
local system defaults in a network environment.
The other two files are more intended for the users and are
described below:
pcps.cfg
This file can contain arguments in the same way that the
command line can have arguments. The arguments may be
spread over several lines and will be processed
sequentially.
PCPS processes arguments from this file first, should it
exist, and then from the command line, so the command line
arguments may over-ride the arguments in this file or even
negate them.
pcps.ppf
Some PostScript printers require some setup or preparation
information sent to them before the output of PCPS. This
support file is provided for such purposes.
Any characters contained in this file will sent to the
output file before any PostScript output from PCPS.
The Printer Preparation file (PPF) may be explicitly specified by
the -pp argument or explicitly disabled by -pp- but if not, the
method for locating both files is identical:
For each file, if the related environment variable is set (See
ENVIRONMENT), the file is sought from the directory specified by
the variable. If the variable is not set or the file is not found
in this directory, the file is sought in the current directory and
if that fails, it is sought in the directory that PCPS originated
from.
SCREEN SUPPORT
PCPS can support differing numbers of lines per screen and provides
a "more" feature when listing font codes or showing usage. At the
[more] prompt you may view the next screen by pressing any key
other than the "q" key which will quit the output.
The Unix version no longer tries to handle the "more" functionality
as too many different Unix flavours handle CURSES with differing
amounts of success, so pcps now opens a pipe to the command "more"
or any command as defined by the user at the top of define.h
SUPPORTED FONTS
PCPS currently supports the default fonts built into an Apple
Laserwriter and assumes that the target printer will "know" these
fonts. PCPS additionally supports its own font named IBMPCFont.
Listed below are the fonts and the code for each that may be used
with the -fo argument:
FontCode Font
AGB AvantGarde-Book
AGBO AvantGarde-BookOblique
AGD AvantGarde-Demi
AGDO AvantGarde-DemiOblique
BD Bookman-Demi
BDI Bookman-DemiItalic
BL Bookman-Light
BLI Bookman-LightItalic
C Courier
CB Courier-Bold
CBO Courier-BoldOblique
CO Courier-Oblique
H Helvetica
HB Helvetica-Bold
HBO Helvetica-BoldOblique
HN Helvetica-Narrow
HNB Helvetica-Narrow-Bold
HNBO Helvetica-Narrow-BoldOblique
HNO Helvetica-Narrow-Oblique
HO Helvetica-Oblique
IBM IBMPCFont <===========(default)
NCSB NewCenturySchlbk-Bold
NCSBI NewCenturySchlbk-BoldItalic
NCSI NewCenturySchlbk-Italic
NCSR NewCenturySchlbk-Roman
PB Palatino-Bold
PBI Palatino-BoldItalic
PI Palatino-Italic
PR Palatino-Roman
S Symbol
TB Times-Bold
TBI Times-BoldItalic
TI Times-Italic
TR Times-Roman
ZCMI ZapfChancery-MediumItalic
ZD ZapfDingbats
PCPS now supports most European characters in all text fonts and
the full IBM/PC character set with its own default font IBMPCFont.
INPUT FILES
If the input file is found to be already in PostScript format, PCPS
will prompt the user for one of three possible actions:
1. [S]kip the file - Self explanatory.
2. [O]utput unchanged - Send the file to the output as it
is.
3. [P]rocess it - Process the file as text resulting
in a printout of the PostScript.
REQUIREMENTS
DOS ONLY VERSION
MS/PC DOS V2.1 is the minimum required version, though for
full compatibility, DOS3.0 or greater is recommended.
FAMILY MODE VERSION
For running under DOS, the above requirements are true.
For running under OS/2 the user should require OS/2 1.0 or
higher though currently PCPS has only been confirmed
running under OS/2 1.3.1, 2.0 and 2.1. The author would
appreciate confirmation that it runs under any other
version.
UNIX VERSIONS
PCPS is available for several flavours of unix boxes - see
the file "unix" for further information.
DIAGNOSTICS
These should be fairly self-explanatory.
AUTHOR
Paul Carapetis
Internet: P.Carapetis@as03.bull.oz.au
BUGS
Far too many arguments, but all of these have been requested by
users, so I guess some-one is using them :-)
Hopefully there are no others but sometimes they manage to sneak
their ugly little heads through, so the author would be extremely
grateful to hear from anyone encountering any of these little
beasties!
NOTES
PostScript is a trademark of Adobe Systems Incorporated.